BBS Toolkit

home *** CD-ROM | disk | FTP | other *** search

/ BBS Toolkit / BBS Toolkit.iso / doors_2 / tshop201.zip / TSHOP.DOC < prev next >

Wrap

Text File | 1992-09-02 | 83KB | 1,858 lines

┌┬┬┬┬┬┬┬┬┬┬┬─┐ ││││││││││││ │ ││││││││││││ │ ││││││││││││ │ ┌───────────┐ ││││││││││││ │ │ ┌────────┘ ├┴┴┴┴┴┴┴┴┴┴┤ │ │ │ ┌─────────────┐ └┬─────────┴┬┘ │ │ │ ┌───────┐ │ ┌──┴──────────┴────────┐ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ └─────────┘ └───────┘ │ └──────────────────────┘ └────────────┐ ┌──────────┘ │ │ │ │ │ │ │ │ └──┘ C O M P U T E R P R O F I L E S 5012 OLDE MILL DRIVE, MARIETTA, GA, 30066 ╔═╦═╗ ╦══╗ ╦═ ╦══╗ ╔══╗ ╦ ╦ ╔══╗ ╦══╗ ╦══╗ ╦══╗ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ╠═ ║ ╠═ ╚══╗ ╠══╣ ║ ║ ╠══╝ ╠══╝ ╠═ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ║ ╩ ╩══╝ ╩══╝ ╩══╝ ╚══╝ ╩ ╩ ╚══╝ ╩ ╩ ╩══╝ The COMPLETE On-Line Shopping System for all types of Bulletin Boards. Version 2.01 Created By Gary R. Smith Copyright (c) 1992 - Computer Profiles Documentation for Single and MultiNode Versions License to Use Agreement ─────────────────────────────────────────────────────────────────────── Computer Profiles, (hereafter referred to as"CP"), grants to the purchaser - and purchaser accepts - a non-transferable and nonexclusive license to use, on a single computer, the software products and accompanying materials provided to the purchaser by CP. Purchaser is hereby licensed only to read the program from its medium into the memory of a single computer solely for the purpose of executing the program. CP shall have the right to terminate this license if purchaser violates any of its provisions. Purchaser agrees that the software products and accompanying materials are the property of CP and that CP shall maintain title to and ownership of the software products at all times. Purchaser agrees to make no more than one (1) additional working copy and one (1) backup copy of the software products for their personal use only. CP makes no warranties of any kind, expressed or implied, with respect to the quality, performance, accuracy, or fitness of the software products for any particular purpose. CP assumes no responsibility for any decisions make or actions taken on the part of the purchaser because of the use of the software products. In no event shall CP, or any of its representatives, be liable for any loss of profit or any other damages, arising out of the use or inability to use this product - even if CP or an authorized agent of such has been advised of the possibility of such damages - or for any claim by any other party. CP reserves the right to make changes, enhancements and improvements to the software products at any time without notice. DISCLAIMER ─────────────────────────────────────────────────────────────── There is made no warranty of any kind, express or implied including, without limitation, any warranties of merchantability and / or fitness for a particular purpose. CP shall not be liable for any damages, whether direct, indirect, special or sequential arising from a failure of this program to operate in the manner desired by the User. CP shall not be liable for any damage to data or property which may be caused directly or indirectly by the User of this program. IN NO EVENT WILL CP BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY. TeleShoppe is a Registered Trademark of Computer Profiles Borland C++ is a Registered Trademark of Borland International CKIT is a Trademark of Data-Comp Information Systems PCBoard is a Registered Trademark of Clark Development Company TeleShoppe 2.01 INTRODUCTION ────────────────────────────────────────────────────────────────────────── Features of TeleShoppe 2.01: o Versatile Database can be used to sell anything! o User-friendly interfaces for both the SYSOP and the User! o Extended Descriptions allow for detailed explanations of each item. o Internal Editor for inputing extended descriptions! o Configurable shipping matrix with weight for each item in the Database. o Break Points for any price range! o Unlimited Database size! o Up to 250 Categories! o Fast, indexed item listings. o Item Search conducted from command line! o Downloadable QuoteS and InvoiceS! o Configurable to accept Visa, MasterCard, American Express, and many more popular credit cards! o Instantly verifies different card types by actual computation! o Can operate at speeds in excess of 115,000 Baud! o Written completely in C++ for increased speed! ---------------------- Upgrading Information When you purchase TeleShoppe you will receive a REGISTRATION NUMBER that will remove all the "EVALUATION COPY" lines and small pauses from the version you are using. There are no time restrictions placed on a particular version of TeleShoppe. (NO annual fees. NO Key files that die out on you after a short time. You OWN this version!) Bug fixes and amendments are free and may be downloaded from the Support BBS. Subsequent releases will be available at a reduced Upgrade price for Registered Users. TeleShoppe 2.01 GETTING STARTED ────────────────────────────────────────────────────────────────────────── Setting Up TeleShoppe If you have never set up Doorware for Bulletin Board Systems, we will walk you through some of the most basic procedures to ensure that you properly configure TeleShoppe with minimum work and time. For those of you who are experienced Sysops, please bear with us! Creating a TeleShoppe should run from its own directory. Create a directory directory from which you wish to run the program. This name may be any name - as long as it conforms to DOS standards. We suggest running it from a sub-directory, like the following example: C:\PCB\DOORS\TSHOP We will use the above example for the remainder of this setup session. Create the directory by moving to your BBS directory (PCB\DOORS), and type: MD TSHOP Copy the You must copy the files from your Distribution Disk or files Shareware ZIP file to your newly-created directory. Example: Copy TSHOP20.ZIP C:\PCB\DOORS\TSHOP Your TSHOP20.ZIP file will now be located in the directory in which you created for TeleShoppe. * │ NOTE: To find the version of each TeleShoppe file you are │ running, check the File Creation Time. If the file │ creation time is 2:00, you have version 2.00 of TeleShoppe. │ If the time is 2:03 then you would be running version 2.03 │ of TeleShoppe. (Please have this version number ready when │ calling our Support Line or BBS for assistance.) * Unpacking If you received your version of TeleShoppe from a Bulletin the files Board, you will have to have a copy of PKUNZIP in your path. Once you are in your TeleShoppe directory, type the following (Where xx is the version number of the copy you received). Example: PKUNZIP TSHOPxx.ZIP TeleShoppe 2.01 GETTING STARTED ────────────────────────────────────────────────────────────────────────── Construct To run TeleShoppe from most Bulletin Boards, you will a batch file need to construct a Batch file that your Bulletin Board Software will use to call the TeleShoppe program. If you are running multi-nodes (and have the multi-node version of TeleShoppe) you will want to make use of environment variables provided by your software. (Note: DO NOT use TeleShoppe in a multi-node setting if you only own the single node version - file corruption will occur!) By creating this batch file, you are configuring it so TeleShoppe will run for that node. Each Batch file you create should be similar to the following example. (We are assuming you are configuring for a single node.) --------------------------------------------------------- Single Node Name of batch file: TSHOP Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\TSHOP Line 3 TSHOP.EXE C:\PCB\PCBOARD.SYS Line 4 CD C:\PCB Line 5 BOARD --------------------------------------------------------- Multi-Node Name of batch file: TSHOP Line 1 @ECHO OFF Line 2 CD C:\PCB\DOORS\TSHOP Line 3 TSHOP.EXE%PCBDRIVE%%PCBDIR%\PCBOARD.SYS Line 4 CD %PCBDIR% Line 5 Board (BBS COMMAND) --------------------------------------------------------- Other BBS Version (Other than PCBoard) Line 1 @ECHO OFF Line 2 CD C:\BBS\DOORS\TSHOP Line 3 TSHOP.EXE DOOR.SYS Line 4 CD C:\BBS Line 5 BBS COMMAND TeleShoppe 2.01 GETTING STARTED ────────────────────────────────────────────────────────────────────────── * │ NOTE: For Non-PCBoard systems that are running nodes, you │ can set environment variables that will allow you to take │ advantage of the above situations. │ │ In your system's AUTOEXEC.BAT file, define your drive and │ directory of your DOOR.SYS files. For example: │ │ SET BBSDRIVE=C: │ SET BBSDIR=\WILDCAT │ │ To use the above variables, you would use the DOS %variables │ in your Batch file as: │ │ Line 3 TSHOP.EXE %BBSDRIVE%%BBSDIR%\DOOR.SYS │ │ This will allow TeleShoppe to determine exactly where the │ NODES files are located. To return to the home directory, │ you would add the following lines to the Batch file: │ │ %BBSDRIVE% //Change back to the original drive │ CD %BBSDIR% //Change to the original directory │ <Board.bat> //Call the board again * Meanings: Line 1 Turns off the local screen echo (Dos 3.3 and above) Line 2 Changes to the directory where TeleShoppe is stored. Line 3 (1) TeleShoppe executable statement (2) The complete path to that nodes PCBoard.sys, DOOR.SYS etc.. Line 4 Changes back to the Bulletin Board's main directory. (Where the BBS is run from) Line 5 The BBS Command (Board in the case of PCBoard) * │ NOTE: Your TeleShoppe batch file should be similar to the │ examples above. Line 3, however, must contain the path to │ the PCBOARD.SYS or DOOR.SYS-type file. * This file is to be placed in the PCBoard or BBS directory. Adding to The next step for setting up TeleShoppe is to add it to BBS Doors your Bulletin Board's Doors file. If you use PCBoard, this file is performed through the PCBoard SETUP program. In the PCBSETUP Editor for Doors, place the name of the Batch file you just created above in a slot for a door, give it a minimum security level, and you're finished. If you prefer to use the DOOR.SYS information, make sure you select to create a DOOR.SYS file. You should select NO SHELL in the TeleShoppe 2.01 GETTING STARTED ────────────────────────────────────────────────────────────────────────── PCBoard setup. You may use either DOOR.SYS, PCBOARD.SYS or other popular door dropfiles. (NOT RBBS, SORRY) Memory - If you have a problem and TCONFIG returns an error of 112, you will have to set a variable pointing to a temp directory in your enviornment. ie..In your autoexec.bat file put the line (or similiar) SET=C:\TEMP (or whatever directory you wish) This is done so that if need be, TCONFIG can swap out to disk if XMS memory is not available. This completes the basic setup of TeleShoppe. Please read further to configure TeleShoppe to run with your Database and software. You are now ready to utilize the configuration program (TCONFIG). This program will assist you in setting up your configuration file (TSHOP.CNF). It is advised that you use the configuration program to edit the TSHOP.CNF file to avoid any problems with incorrect configu- rations. TCONFIG, as you will see, is more than just a config file writer. It is also the heart of the Database management/creation center. From TCONFIG you can perform all of your maintenance for TeleShoppe. TeleShoppe can work on any 100% IBM compatible system. The basic hardware requirements are listed below: IBM Processor 8088 or better Hard drive (Recommend 20 meg or better) Mono, EGA, VGA Monitor 300 or higher speed modem (Up to 115000 Baud) The TCONFIG file must be executed from TeleShoppe's own directory. If not, you will re-create all the necessary files to run TeleShoppe as defaults in whatever directory you are in. To begin, type TCONFIG from the command line. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── Main Menu HELP Context-sensitive help is provided throughout the TCONFIG program. When you are at an item that you desire some help, or need to know what the defaults would be, press F1. Pressing F1 will bring up to the screen a help index system. By pressing Index, You can navigate anywhere's in the help system with a single key stroke. 1. CONFIGURATION Basic system information is entered in this portion of the program. Listed below is a description of each line item and what should be placed in the appropriate box. BOARDNAME - Place the name of your Bulletin Board System on this line. You have a maximum of 50 characters. (This should match your registration name exactly. If not, contact the Support Board for new registration information). REGISTRATION NUMBER - Place the registration number you received from CP or the Support Board on this line. If you have not registered your version of TeleShoppe, Place 00000 on this line - or leave the default. CARD PROCESSOR - Place the name of your card processor on this line. (This is the name of the company that appears on the Users credit card statement.) WARNING FILE NAME - This is the file that is displayed to the User prior to entering the purchasing area. This warning file is a deterrent that will cause some Users that had bad intentions to turn back. This file should contain information regarding the use of fraudulent credit cards, etc. This file can be titled any name that is within the DOS boundaries for filenames. The files WARN and WARNG are provided as samples. Both if used should be edited with a text editor to personalize them for your system. To accept the default screen that is contained within TeleShoppe, place a "Y" in the box (without quotation marks). TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── OPENING SCREEN FILENAME - (Registered Versions Only) - If you have designed an ASCII/ANSI screen that you would like to show your Users instead of the default opening screen, then place that file name in this position. ASCII file- names should be 7 characters long. By appending a "G" to the filename, the graphics version will be shown to the User (if one exists, and if the User is in graphics mode). 2. FINANCIAL INFORMATION Most of TeleShoppe's financial information is contained in this area. Other financial data may be found in Item #3 of the Main Menu (Misc/Shipping). CREDIT CARDS ACCEPTED - Here you will find the list of credit cards that TeleShoppe automatically checks for validity. Along each side you must enter either a "Y" or a "N" to indicate that you will or will not accept the card from your Users. Each card must be set individually. * │ NOTE: There is extensive card checking incorporated │ within TeleShoppe to validate credit cards. We cannot, │ however, guarantee that the User is not using a card │ that is over the credit limit, stolen, etc. All cards │ are checked using a modulus math routine, length and │ validation numbers. * * │ NOTE: Credit cards are not mandatory and may be turned │ off in Main Menu Item #3. * USE BREAK POINT AVERAGES - Enter a "Y" or "N" to use the Break Point averages listed to the right of the screen. * │ NOTE: Break Points are used when the retailer wants to │ give a percentage price break for quantity buying. (See │ Break Points below for information on how to use them.) * HANDLING PERCENTAGE - Place the percentage that you will charge for credit card handling, or other handling charges you are applying, on this line. (The value listed here is a percentage.) TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── The decimal point MUST be included on this line. The handling charges are based on the following formula: Total = (Total Charges * Handling) + Total Charges If no handling charge is to be made then place .00 on this line (Default) * │ NOTE: When designing your Invoices and Receipts: if │ handling is equal to zero, that line will be deleted │ from your Invoice/Receipt. * TAX PERCENTAGE - Place the percentage of tax that your State/Province etc. places on taxable goods. If no tax is ever to be charged for the products you offer then place .00 (Default) in this field, otherwise place the appropriate amount here. The decimal point MUST be included on this line. The tax charges are based on the following formula: Total = (Total Charges * Tax) + Total Charges + Handling VARIABLE ADDED TAX - If your country places a VAT on different goods, TeleShoppe will now handle these products properly. Place the percentage of tax placed on VAT items. (There are entries in the Database to mark whether that particular item will receive the VAT applied to it or not) The decimal point MUST be included on this line. The VAT charges are based on the following formula: (Item Total * VAT) = TotalVat If no Variable Added Tax is to be used, then place .00 in this position. STATE TO CHARGE TAX - The two (2) letter state designator for your state should be placed on this line - if your state requires that you charge sales tax. The following codes may be substituted to personalize your system, regardless of what country you are in. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── ALL - Charge all Users tax regardless of state/ province. By placing the word ALL on this line, everyone that purchases something will be charged tax. This could be used if the country charges a luxury tax on all items and does not charge different provinces different amounts. NO - Charge no User regardless of state/ province any tax. This will cause all Users regardless of where they are from to be charged no tax. TWO CHARACTER STATE - If TeleShoppe finds a two letter state code here and it matches with the Users indicated home state then that User alone will be charged tax. If the two states do not match, that User is not charged tax. In most cases you will place your state letter designator here since most states charge sales tax. * │ NOTE : PRESSING 'ESC' WILL ABORT ANY ENTRY, PRESSING │ 'F10' WILL SAVE THE ENTRIES TO DISK. * BREAK POINT (1-10) - If you desire to give your customers a price break for quantity buying you may do so automatically by entering the appropriate information in the Break Point area. A BREAK POINT is a percentage value that, if a buyer is within the range of two dollar values, will be charged that percentage assigned instead of the markup percentage assigned in the Database for that particular sale. With that said, let's give you a simple example: In the Database you have Monitors priced at 50.00 with a markup percentage of 30% (.30). You have decided that customers who purchase items over 200 dollars will be automatically eligible for a markup of only 28%. To handle this you will put the following values in the BREAK POINT area: Max Pct Break Point 1.........200 .28 Break Point 2.........500 .25 TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── The above matrix allows for all purchases under $200 to be assigned the markup value in the Database. All purchases between $200.00 and $499.99 will be charged a .28% markup instead of the markup assigned in the Database. * │ NOTE: On some purchases - because of the way your │ individual markup may be on items - the Break Point │ purchase could be more than the regular price. In this │ instance, No break price would be shown to the caller. * The same is with purchases above $500.00, They would be eligible for the 25% value in the Break Point area. If Break Points are not desired, Just enter a "N" in the appropriate block on this screen. SAVING AND ABORTING - To save the information you have entered on the screen, Press F10, to abort any changed information Press ESC. 3. MISC/SHIPPING TeleShoppe's Miscellaneous and Shipping Information is kept within this area of TCONFIG. To save your information when completed, Press F10. To abort or cancel any changed information, Press ESC. ALLOW THE USE OF COD - If will allow your Users the option of having their merchandise shipped Cash On Delivery (COD), place a "Y" in this block. If not you must enter "N" in this position. * │ NOTE: By selecting either "COD" or "Checks or Credit │ Cards," your menu presented to the Users in the On-Line │ TeleShoppe will be adjusted accordingly. This is done │ automatically and does not give the User the chance to │ input wrongful payment type. * ALLOW THE USE OF CHECKS/MO - To allow Users to purchase items with checks or money orders place a "Y" in this area, otherwise place a "N" here. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── ALLOW THE USE OF CREDIT CARDS - If you are going to allow your Users to use credit cards on your system then place a "Y" here and a "N" if you will not. Credit cards that are to be accepted should be configured under Main Menu Item #2 (Financial Information). APPLY HANDLING TO COD - If you will apply the handling percentage assigned in Main Menu Item #2 to all COD requests, place a "Y" here. If not, place a "N" in this area. * │ NOTE: COD handling charges can be better handled by using │ the shipping matrix provided. However, this field is still │ presented for your use. * APPLY HANDLING TO CKS/MO - If you will apply the handling percentage assigned in Main Menu Item #2 to CHECKS/MO purchases, place a "Y" here, otherwise place a "N" in this field. APPLY HANDLING TO CCARDS - If you wish to apply the handling charge assigned under Main Menu Item #2 to all CREDIT CARD orders then place a "Y" in this field. If not, enter "N". Invoice FILENAME - This file name is the name of the file that contains the format of the Invoice file you designed using the TeleShoppe @ codes. (Examples of this file are contained in the file Invoice.TXT). This file is read and when TeleShoppe encounters the "@" codes, it will replace the code with the substitution variable information requested. Example: If in your Invoice.TXT file you place: @FNAME@ conducted a purchase and John Smith was on line....TeleShoppe would write the Invoice as: John Smith conducted a purchase. Using this method you design your Invoice file in any manner you wish. This is the file that you will use to conduct your business with, it is not erased as is the receipt file. (More on this later). TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── * │ NOTE: A complete listing of all TeleShoppe @ codes is │ available in APPENDIX D. * RECEIPT FILENAME - This file is presented to the User online as a Receipt or Quote. This file is designed in the same manner as the Invoice.TXT file. The receipt file can contain TeleShoppe @ codes and designed to fit your needs. If in your RECEIPT.TXT file you place: @FNAME@ conducted a purchase and John Smith was on line....TeleShoppe would write the Invoice as: John Smith conducted a purchase. * │ NOTE: THIS FILE IS DELETED UPON THE User DEPARTING │ THE DOOR. * This file may be downloaded as a Quote or as a Receipt after a purchase is completed. * │ NOTE: Unless the User has entered personal data before, │ tax information will not be computed since the state of the │ person is not used. (On Quotes Only) * SHIPPING INFORMATION The shipping matrix provided with TeleShoppe was designed to be simple to use and implement. Knowing that this system is being used all over the world, a simple but somewhat effective method had to be devised. We feel that we have accomplished this. (More elaborate systems exist - but do not accommodate many of the other countries of the world.) SHIPPING (1 - 5) - Place the name of the carrier in this block. You can have up to 5 shipping types or vendors, such as: UPS BLUE, UPS OVERNIGHT, FEDEX, FEDEX RED, US MAIL, etc. You are allowed up to 15 characters for each entry. * │ NOTE: Remember by pressing F1 you can have context │ sensitive help! * TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── BASE RATE - Enter the base rate that any purchase will receive for using this vendor/method of shipping. If all purchases should receive a minimum of a $3.00 charge, then place 3.00 here. (See the example after the explanations) MAXIMUM WEIGHT - This is the maximum weight that an item can weigh and still receive the charge of BASE RATE. If an item's weight is equal to or less than this weight, then only the BASE RATE will be charged. CHARGE PER OZ - This is the price per ounce that will be added for an item that is over the MAXIMUM WEIGHT amount. (*ratio) Example: Your User selects to use MA & PA shipping, which you have assigned the values of: 2.00 to Base Rate, 5 lbs for MAXIMUM WEIGHT and .0625 for CHARGE PER OZ. (.0625 * 16 = 1$ per pound charge). If the User selects a package that weighs in at 1.5 lbs, then the User will be charged $2.00 for shipping. (Minimum Amount) If the User selects a package that weighs in at 1 lb. and orders two of the same product, the User will be charged $2.00 (Max charge) for shipping, since the total weight of LIKE items is less than the MAXIMUM WEIGHT. If the User selects 4 of those items at 1.5 lbs each then the User is charged $2.00 for maximum weight charge, and then the remainder of the weight is multiplied by the Charge per oz. figure (16 oz per LB) to come up with the remaining amount. In this example 6 (4x1.5) - 5 = 1 (Extra weight) * .625 (Charge Per Oz) = 1.00 Make sense? Lets examine this. If you have 4 items at 1.5 lbs each, that gives you a total of 6 lbs. Maximum weight was 5 lbs - so the difference between 6 and 5 lbs is 1 lp. That one lp (consisting of 16 oz) is multiplied by .0625, which will yield a charge of $1.00. When applied to the BASE RATE yields a shipping charge of $3.00. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── The CHARGE PER OZ is a ratio that is multiplied by 16 (oz) to provide the charge for all weights exceeding the MAXIMUM WEIGHT amount. Using .0625 * 16 yields 1 dollar per pound. NOTE: Shipping is calculated on individual items, item weights are NOT combined to yield the final weight except on the same item. 4. Database MAINTENANCE This option is where you will enter all of your Database information. If you not yet created a Database, please skip ahead to Main Menu Item #8 (Create A Database). Entering information in this area without first creating a Database could damage other TeleShoppe system files. Once entering the Database area, you must create your first record. This is accomplished by pressing the INSERT key and adding the appropriate data. After completing the first record you can press F10 to save the information or ESC to abort the entries. Database operation will be discussed in greater detail after the remarks. Scrolling - There are two different options when scrolling through the Database. You may scroll in either record number order or by category order (Alphabetical). The following is a listing of the keys and their operations within the Database MAINTENANCE section). KEY OPERATIONS F2 - [EDIT] When this key is pressed the Database record you are currently positioned at is placed in the Edit Mode. You then may change any field within the record. Pressing F10 when in Edit Mode will save the entries. Pressing 'ESC' will abandon the operation. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── F3 - EDITOR - When viewing a record on screen, you can display (EDIT) the extended descriptions by pressing the F3 key. This will bring up the pop Editor contained within TCONFIG that allows editing of extended descriptions. EXTENDED DESCRIPTIONS - These are the descriptions that are shown to the User when they select V)iew from the command prompt in TeleShoppe. Any text that is contained within the first 10 LINES is shown to the User, all text below the 10th line is maintained as a Comment for the Sysop. The key operations while in the editor are: Enter Insert line Home Go to beginning of line End Go to end of line Left Move one char left Right Move one char right Up Move up one line Down Move down one line PgUp Move up one screen full PgDn Move down one screen Ins Toggle Insert/Overwrite Del Delete character BkSpace Delete previous character Ctrl-BkSpace Delete word Ctrl-Y Delete Line Ctrl-Grey(-) Delete to end of line Alt-S Save extended description Alt-X Quit editor (Save if changed) F4 - [Set Viewing Mode] This key allows you to toggle between record number order or by category order. The order you are in is displayed in the lower right hand corner of the display. (Categories are sorted alphabetically.) F6 - [Today's Date] When this key is depressed, the current date is placed in the field you are in. It is meant to be used with the Lastdate field. F10 - [SAVE] When F10 is pressed the edited fields are saved to disk. To avoid saving, just press ESC. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── ESC - [Abort] Pressing ESC will abort the current operation or, if you are in the viewing mode, pressing ESC will place you back at the Main Menu. PgUp - Moves you through the Database by increasing the records by 10. PgDn - Moves you thorough the Database by decreasing the records by 10. Ins - [INSERT] By pressing the Insert key when you are in the editing mode you will be able to INSERT a new record. You are automatically placed in the Editing mode once this key has been pressed. Del - [DELETE] By pressing the delete key you will mark a record for deletion. Note that this record is not actually deleted from the Database but is marked for deletion. The category field will be marked as "*DELETED". When a User scrolls through a Database listing in TeleShoppe, this record is not shown to the User. To activate the record you only need to edit the category field and place a valid category name in it. If you wish to purge all records that have been marked for deletion, you will have to pack the Database. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── Fields within TeleShoppe The following is the structure used for the TeleShoppe Database. FieldName Type Size Decimals CATEGORY C 15 NOMENCLA C 35 COST N 15 2 LASTDATE D 8 MARKUP N 10 3 STOCKNO C 25 VENDER C 25 DBVERSION C 15 MANUFACTU C 15 VTAX C 1 WEIGHT N 10 3 DBTEXT M 10 ( C - Character, N - Numeric, D - Date, M - Memo ) The following is a list of the fields within the Database and their maximum and minimum limits. Category - This is the listings or categories that all items are placed under. You can have a maximum of 250 different categories to list your items. This field is automatically inputted as Upper Case and can have a maximum length of 15 characters. Stock Number - This is the manufacturer's stock number - or your specific number for the product. This field can have a length of 25 characters. Manufacture - This is the manufacturer's name and has a field length of 15 characters. Nomenclature - The field is a one-line description of the product. You can describe the product here with a field length of 35 characters. Longer descriptions are available as Extended Descriptions. Weight - The item's weight - to the nearest pound - is to be placed here. If the item weight is left as 0 LBS, then shipping will not be figured for this item. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── Cost - Place the cost of the item here. You should include the decimal point. If one is not found, a value of .00 will be appended to your cost. Markup - This is the percentage of markup the item is to have. For example if your item cost you 10.00 and you wanted a 10% profit on this item you would place a .10 in this field. The formula for this field is calculated as follows: Unit Cost = COST + (Markup * COST) Utilizing this method makes it possible for you to charge different markup costs per item instead of one percentage across the board. Total - This field is updated after the record has been saved with the F10 key. This field contains the Unit Cost times the Markup Value: Total = Cost * Markup Use Vtax - If the Variable Added Tax configured in Main Menu Item #2 is to be used then place a "Y" here else you may enter a "N" or leave blank. If the field is blank or contains a "N" then the Variable Added Tax will NOT be calculated for this product alone. This is not a global field. Each item is examined individually. Vender - This is the name of the vendor you receive the product from. This field can have a length of 25 characters. Dbversion - This is a field for a version of your Database. Some Users will indicate their first version on start up, and each sub- sequential update as a new version. You may also receive different versions from different vendors, and this field will help you keep track of what version the item came from. Lastdate - This field is for the date you last updated this item. To insert today's date, highlight the area and press the F6 key. Today's date will automatically be typed in for you. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── 5. PACK Database USE WITH CAUTION - All items marked for deletion in your Database as *DELETED will be removed. These items marked as such are NOT shown to your Users. (You can maintain outdated items without showing them to your Users by only marking them for deletion.) This option will remove any records you have marked for deletion and sort the Database in category order at the same time. After packing, the Database the program automatically updates the category listings from what is available in your Database. (Remember: you may have 250 different categories.) Use this option ONLY if you want to delete the items you have marked for deletion. 6. UPDATE CATEGORIES Update Categories scans through the Index Files and reads all of the current categories you have listed. You may have a maximum of 250 categories of items. Use this option if you have added or deleted items in the Database. 7. EXPORT Database Export Database writes the contents of your Database to a comma-delimited file with the file name of TSHOP.TXT. This file is in the same format as the file for Importing a Database from a text file (Format listed in the beginning of this section). If you have reason to use your Database in other programs, this option can be used with most other popular programs - dbase III/IV will import a comma- delimited file. For Database structure, see the section concerning Importing a Database. * │ IMPORTANT NOTE: Extended Descriptions can not be imported │ or exported into TeleShoppe since they are contained in │ separate Memo files. * TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── 8. CREATE A Database Create a Database is where all the Databases for TeleShoppe are initially created. If you will be creating a Database from scratch, the following commands apply. If you are importing a comma-delimited text file to start your Database, skip to the next section. ____________________________________ Legend: Ques = Question you see on the screen. > = Enter this entry. ____________________________________ CREATING FROM SCRATCH: Ques: Are you creating this Database from a text file? > Enter "N" for No Ques: This will delete any previous TSHOP.DBF file. Are you sure you want to continue? > Enter "Y" for yes * │ NOTE 1: If you have previously created a Database file this │ option will delete and destroy all references to the prior │ Database. Please use this option with care. * │ NOTE 2: You should now proceed to the next section to │ enter Database items. You have created a empty Database. * │ NOTE 3: If you create a Database, the Extended Descriptions │ are replaced with an EMPTY file each time. USE WITH CAUTION * TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── CREATING FROM A COMMA-DELIMITED TEXT FILE: If you are creating a Database from a text file, It must be comma-delimited. (This means that each individual variable must be separated by a comma.) Please make sure before you begin that none of your item descriptions contain commas, as this will disrupt the normal operation of TCONFIG. Your text file must be constructed in the following manner. Each item shall consist of one line and shall be in the following format. (Our lines are broken down because of editing space. Your format should all be on one line.) C = Characters Allowed N = Numeric field (Include decimal point) D = Date field M = Memo field Text File Format CATEGORY C 15 NOMENCLA C 35 COST N 15 2 LASTDATE D 8 MARKUP N 10 3 STOCKNO C 25 VENDER C 25 DBVERSION C 15 MANUFACTU C 15 VTAX C 1 WEIGHT N 10 3 DBTEXT M 10 Category[C15], Nomencla[C35], Cost[N2], Lastdate[D], Markup[N3], Stockno[C25], Vendor[C25], DBVersion[C15], Manufactu[C15], Vtax[C1], Weight[N3] NOTE: Remember that TConfig is not reading in the MEMO field so that field MUST be left off. You should have a total of 10 commas. THE SAMPLE Database, SAMPLE.DB, MAY BE USED TO PRACTICE WITH WHEN CREATING A Database. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── All entries are read in as TEXT and MUST NOT include Quotes around the text. Cost/Markup are numeric fields and should be imputed as such. Lastdate is a character field and must be in the format of 01/01/1992 (day/mo/yr) or left blank. This field will be used to denote changes in your Database and the date it occurred. Since this is the first day the date will automatically be filled in with today's date if it finds a blank field. Follow the following commands to create a Database from a text file: Ques = Question you see on the screen. > = Enter this entry. Ques: Are you creating the Database from a text file? > Enter "Y" for yes Ques: Enter the name of the Database text file. > Enter "Name of your text file" Ques: This will delete any previous TSHOP.DBF file. Are you sure you want to continue? > Enter "Y" for yes If the file is found the record write / reading process is started. If not, you are returned to the Main Menu after being advised that the file was not found. NOTE: The Database has now been created and contains 1 record. You should advance to the next section for editing the Database. TeleShoppe 2.01 TCONFIG ────────────────────────────────────────────────────────────────────────── NOTE: TeleShoppe Databases are compatible with dbase III and IV record structures. 9. EXIT PROGRAM Using this option should be the only way you exit TCONFIG to DOS. Rebooting the machine while TCONFIG is running could cause damage to your Database and Index Files. TCONFIG clears memory and closes all files that it opened when exited properly. END DOCUMENTATION FOR TCONFIG.EXE TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── TeleShoppe Main Menu (On-Line) Welcome to the TeleShoppe Online store. We hope that your Users will find this program simple and easy to use, and that you will find it easy and versatile. When first starting up TeleShoppe from your Bulletin Board System you are presented with the opening screen. If you registered your version of TeleShoppe, you may design your own opening screens. (See Item #1 of the TCONFIG program). ┌─────────────────────────────────┐ │ ┌─────────────────────────────┐ │ │ │ ┌─────────────────────┐ │ │ │ │ │ TeleShoppe (tm) 2.01│ │ │ │ │ └─────────────────────┘ │ │ │ │ Copyright 1992 (c) │ │ │ │ Computer Profiles Ltd. │ │ │ │ ALL RIGHTS RESERVED │ │ │ └─────────────────────────────┘ │ └─────────────────────────────────┘ The Main Menu consists of 8 different selections. From it, your Users may move throughout the TeleShoppe program, creating and modifying their choices.We will discuss each of these items in detail, describing their full potential. We will also describe their intended functions. ┌─────────────────────────────────────────────────────────────────┐ │ ┌─────────────────────────────────────────────────────────────┐ │ │ │ Main Menu │ │ │ │ │ │ │ │ 1. List Items by Category 5. Download Quoted Invoice │ │ │ │ 2. Edit marked items 6. Order selected items │ │ │ │ 3. View marked items 7. Instructions │ │ │ │ 4. Show Invoice Quote 8. Return to main board │ │ │ │ │ │ │ └─────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘ TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── 1. LIST ITEMS BY CATEGORY Selecting this option will present the User with the categories you have setup in your Database file. The User will be allowed to choose from this screen the items that they wish to view. This is done automatically each time and does not require that the operator design a screen each time a category is either created or deleted. ┌────────────────────────────────────┐ │ Categories │ └────────────────────────────────────┘ 1. Accessories 2. Men's clothing 3. Women's clothing Enter S)earch, or Selection Number, E)nd The above screen is presented to the User. The User has the option of searching for a keyword item in the Database, Viewing a category or typing "E" to return them to the Main Menu. NOTE: If you have updated your Database listing and do not see *new* categories you may have just entered, run the TCONFIG program and run the option for "Update Categories" NOTE: If you have marked an item for deletion, that item will not show up in the category listing. This enables you to keep track of outdated items without actually removing them from the Database. SEARCH - The search function will ask the User Enter the string to search for: At this prompt, the User should enter the string to search for. If the User types in DRIVE, TeleShoppe will search through the entire Database until all descriptions with the word drive have been shown to the User, or it reaches the end of the Database. The User can stop the search at any time by pressing CTRL + K. The User may also end the operation by pressing A)bort. This will allow the User to either V)iew the extended description of the item or select the item for marking. TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── If the User elects to view a CATEGORY by number the User will be presented with a screen of information regarding the entries within that category. The listing the User sees will list the item number as it corresponds to the record number in the Database, item description, and unit cost. This cost is a total of (Cost * Markup) + Cost. ┌──────────────────────────────────────────────────────────────────┐ │Num. Category Item Listing Price │ └──────────────────────────────────────────────────────────────────┘ 1 ACCESSORIES Diskette 360k 5.25 Ds/Dd .50 2 ............... VGA Adapter 12.00 Enter = more, V)iew description, Item # to mark, E)nd: The User now has the option of pressing enter which will view more items if they are available within this category, or "V" for viewing the extended description: When viewing a extended description, a portion of the screen is cleared so the full ten lines allowed are shown to the User. ┌──────────────────────────────────────────────────────────────────┐ │Num. Category Item Listing Price │ └──────────────────────────────────────────────────────────────────┘ 1 ACCESSORIES Diskette 360k 5.25 Ds/Dd .50 2 ............... VGA Adapter 12.00 -------------------------------------------------------------------- Extended Description for item number 1 Diskette 360k 5.25 Ds/Dd, Sorry no detailed information available. If no extended description is available, the extended description will appear as above. This lets the User know that no additional information is available. Once the User is done viewing the description they will press enter and the screen will be replaced with the Database information again. TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── NOTE: If the User is doing a search and then does a view on an item the screen information that was erased IS NOT redrawn. If the User decides to mark an item, then the User will insert the item number on the line. I.E., to mark item number 101, the User would enter: Enter = more, V)iew description, Item # to mark, E)nd: 101 If the User enters a number for an item, that number will be placed in a buffer so that the User can view/edit that item later without remembering which number they desired to view. The User will then be asked for the quantity of the item they wish to purchase. The User should enter the quantity of the item they wish to purchase: Item number 101 marked, Enter quantity desired: 3 To end the viewing of a category the User will select "E" to back up or <RETURN> until the end of the category is reached. Once at the category screen, the User may enter "E" to return to the Main Menu. 2. EDIT MARKED ITEMS This choice allows the User to revise what they originally marked when viewing the items. The User may either keep or discard the items, or change the quantity they wish to order. When pressing #2, the User is presented with their listing of items in the following manner. ┌──────────────────────────────────────────────────────────────────┐ │Editing Mode Unit Extended │ │Number Item Listing Price Qty Price │ └──────────────────────────────────────────────────────────────────┘ 1 Accessories VGA Adapter 12.00 This item marked for purchase. Keep it? (Y/n) TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── If the User desires to keep the item, they enter "Y" (or return) to keep the item (Default is Yes). The User is then asked if the quantity is correct, or to enter the correct amount. If the User keeps the item, it is displayed in order at the top of the screen. If the User decides to discard the item, it is removed form the marked listing and is no longer shown. This process is continued until all items marked for purchase have been covered. Once completed, the User will now have a valid list of items and quantities - and can prepare to view an Invoice or purchase the items. The User is placed back at the Main Menu after completion. 3. VIEW MARKED ITEMS Selecting item 3 will allow the User to VIEW quickly (NOT EDIT) the items they have marked for purchase. When this is selected the screen is cleared the following headings are presented to the User: ┌──────────────────────────────────────────────────────────────────┐ │Viewing Mode Unit Extended │ │Number Item Listing Price Qty Price │ └──────────────────────────────────────────────────────────────────┘ Once a User has viewed all the flagged items, Pressing return will return them back to the Main Menu. 4. SHOW Invoice Quote: This item is unique in that a User can view an actual Quoted Invoice prior to paying for any item. By selecting this option, a Quote is created from the items a User has selected and then displayed to the User. This Quoted information is deleted after the User departs the door. NOTE: No handling charges or shipping information is shown to the User during a Quote. TAX is ALWAYS shown since at this point it is nearly impossible to tell which state the User is from. NOTE: See Creating RECEIPT.TXT for information on creating your Invoice and receipts. TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── 5. DOWNLOAD Quoted Invoice: With the Download Quoted Invoice option, Users may download a Quoted Invoice once they have created one by selecting items. When selecting this option the User will be presented with a screen to select their desired protocol to download the Quoted Invoice. ┌──────────────────────────────┐ │ ┌──────────────────────────┐ │ │ │ ┌────────────────────┐ │ │ │ │ │ Select Protocol │ │ │ │ │ └────────────────────┘ │ │ │ │ 1) Zmodem │ │ │ │ 2) Ymodem │ │ │ │ 3) Xmodem │ │ │ │ C) ancel │ │ │ └──────────────────────────┘ │ └──────────────────────────────┘ Enter Selection: Once the User selects the protocol, the screen will tell them that the INV_<NODE>.TXT file is ready for download, Once the User presses a key the download with that protocol will transfer the Quote. When the download is complete if it is successful the User is put back at the Main Menu, If the transfer was unsuccessful or canceled the User is brought back to this menu for further processing. 6. ORDER SELECTED ITEMS The Order Selected Items option is the heart of the TeleShoppe on-line system. In this section, your Users will select their type of payment desired, enter their personal information, and order the items that they have previously marked for purchase. When the User first selects item 6, a warning screen (either the default one provided with TeleShoppe or a User defined screen) is shown to the User. (See Item #1 of the Main Menu in TCONFIG) NOTE: The information in the warning file should contain as much information about fraudulent use of credit cards as possible to attempt to ward off any potential abUsers. TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── Next, the User is presented the menu to select the type payment. You have previously defined these options in TCONFIG. If all payment types were selected in TCONFIG then the User will be presented with the following menu (Or a similar menu depending on services provided). ┌────────────────────────────────────┐ │ ┌────────────────────────────────┐ │ │ │ Preferred Payment Type │ │ │ │ │ │ │ │ 1) Credit Card │ │ │ │ 2) Cash on Delivery (COD) │ │ │ │ 3) Check/Money Order │ │ │ │ C) ancel │ │ │ │ │ │ │ └────────────────────────────────┘ │ └────────────────────────────────────┘ The User should select their preferred method. Once this is complete the User is presented with the Data Entry screen where all the personal information is entered. If the User selected the Credit Card payment type, their number is entered and then automatically checked by TeleShoppe. The only credit cards allowed are the ones you defined in the TCONFIG program. ┌───────────────────────────────────────────────────────────────────── │ I NOTE: TeleShoppe makes use of a file name "TRASHCAN" which │ M contains the numbers of credit cards that are not accepted by your │ P system. They filename MUST be TRASHCAN and there should be no │ O spaces or other characters in the number. i.e.,... │ R │ T 0034-0099-3433-9393 illegal │ A 0034 0099 3433 9393 illegal │ N 0034009934339393 acceptable │ T │ This file MUST exist in the TeleShoppe directory. └───────────────────────────────────────────────────────────────────── If either of the other options is selected, then the User is only prompted for Name, Address, etc.. Once all the personal data is entered, the User is given the chance to change any information that was entered. The only information not allowed to be changed is a validated credit card number. (This is to prevent tampering.) TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── After all the data is entered and is correct the User will enter "C" to continue with the purchase. The Purchase menu is next presented to the User. ┌────────────────────────────────────┐ │ ┌────────────────────────────────┐ │ │ │ Purchase Menu │ │ │ │ │ │ │ │ 1) Mark items for purchase │ │ │ │ 2) Edit marked list │ │ │ │ 3) View marked list │ │ │ │ 4) Continue with Purchase │ │ │ │ 5) Cancel, Return to Menu │ │ │ │ │ │ │ └────────────────────────────────┘ │ └────────────────────────────────────┘ This menu is almost the same as the Main Menu. It allows the User to go back to the viewing and marking section, or to re-edit their purchases before proceeding. When completed with this menu the User will select #4 to continue or #5 to back out of this area completely. (The items still remain marked for the User). When continuing, the User is present the final copy of the Invoice, This Invoice will contain all taxes, shipping and handling charges and shows the EXACT amount the User will be charged. After viewing this Invoice the User is once again asked for final verification. (Some Users are really timid around this point - these extra steps are to make them feel more comfortable in knowing they are in complete control of the sale). ┌──────────────────────────────┐ │ ┌──────────────────────────┐ │ │ │ ┌────────────────────┐ │ │ │ │ │ Final Verification │ │ │ │ │ └────────────────────┘ │ │ │ │ │ │ │ │ Enter (Y)es to finalize │ │ │ │ Enter (C) to cancel │ │ │ │ │ │ │ └──────────────────────────┘ │ └──────────────────────────────┘ TeleShoppe 2.01 TeleShoppe ON-LINE ────────────────────────────────────────────────────────────────────────── Upon selecting (C) the User would be placed back at the Main Menu and no transactions would take place. If the User selects (Y) then the Invoice is created, the Sales Receipt is created and the User is placed at the download menu once again. This gives the User the chance to download the menu. After downloading the User will be returned to the Main Menu. 7. INSTRUCTIONS The Instructions command helps with any of TeleShoppe's features a User may be having problems understanding. This is a scrolling text file (TSHOP.INS) that may be (and should be) edited by the Sysop. If you have any special instructions for your customers you should place it in this file. (You may want to put shipping times, etc. in this file.) 8. RETURN TO MAIN BOARD Use this option to return to the Bulletin Board. When this option is selected, All files are closed and communication monitoring is once again turned over to the bulletin board program. This should be the only way that TeleShoppe is exited. END OF TeleShoppe DOCUMENTATION TeleShoppe 2.01 APPENDIX A ────────────────────────────────────────────────────────────────────────── APPENDIX A TRASHCAN FILE The trashcan file is a listing of ALL credit card numbers that you do not wish to have access to your products. If a credit card number is placed in this file then the User of that card will be informed that their information is invalid and it will be reported. This file has a format of one number per line. There should be NO spaces or other characters between the numbers. ex. 1234567812345678 The file name of this file is TRASHCAN and can not be changed. It is a text file, so you may use your favorite text editor to edit the file. the file MUST exist. TeleShoppe 2.01 APPENDIX B ────────────────────────────────────────────────────────────────────────── APPENDIX B Invoice INFORMATION Your Invoice files are created with the title of # and a suffix of .INV, for example, your 21st order will be labeled "21.INV" and will be in your TeleShoppe directory. These files are written in a numerical sequence. If you wish to start with a higher number, edit the TSHOP.CNT file with an ASCII editor and place the number you wish to begin with inside of this file. (It must be a numeric input) It is not within the scope of this document to describe procedures for processing your Invoices. Your credit card merchant should provide this information for you. A file with the name of PURCHASE.NODE is written to the default TeleShoppe directory each time an Invoice is create (i.e.,.. a purchase has taken place). This file contains a message that a purchase has taken place. It is up to the sysop to process this file after the User finishes with TeleShoppe. May we suggest that you use Txt2msg to write the message to your PCBoard conference and then delete the file prior to returning to the board. TeleShoppe 2.01 APPENDIX C ────────────────────────────────────────────────────────────────────────── APPENDIX C COMMUNICATIONS The Invoices and Quotes may be downloaded by your Users. TeleShoppe makes use of the DSZ communication software. This file (DSZ) must exist in the path if TeleShoppe is to work properly. The batch files TxZ.BAT may be modified to suit your BBS software. For those of you that understand Ports and IRQ settings! NOTE: If you need to specify a non-standard port address and IRQ, then the syntax is PORT:AAAA:X where AAAA is the base address and X is the IRQ. It doesn't matter whether PORT:AAAA:X is the third or fourth parameter as long as it is the LAST parameter passed. PORT is optional, and TeleShoppe will default to standard addresses and irqs if it not used based on the port number read from the BBS file. TeleShoppe will assume COM1 = 03F8 IRQ 4, COM2 = 02E8 IRQ3, COM3 = 03E8 IRQ4 and COM4 = 02E8 IRQ 3. If you have a different non-standard port address and irq, you could then use the PORT cmd to change the defaults. TeleShoppe will also support the use of FOSSIL drivers. The syntax for a FOSSIL driver is: PORT:F:P. The 'F' tells TeleShoppe to use a Fossil driver for it's communications. The 'P' following it tells it which port to use for the Fossil. Example - PORT:F:1, tells TeleShoppe to use a fossil driver for port 1. TeleShoppe 2.01 APPENDIX D ────────────────────────────────────────────────────────────────────────── APPENDIX D CREATING Invoice.TXT AND RECEIPT.TXT You can now create your own Invoice and receipt files using the @ codes. To use these codes you just place them in a normal text file, and TeleShoppe will replace your @code with the appropriate information. i.e.,. In your Invoice file you place: Our Bulletin Board Name is @BOARD@ The User will receive: Our Bulletin Board Name is Random Access! The following @ Codes may be used to format your Invoices and receipts. (For examples, see the Invoice.TXT and RECEIPT.TXT files supplied.) NOTE: that items marked with * are stripped if there is no info, for example - if you @VTAX@ on a line and there is no variable tax for this purchase then this line is stripped out of the Invoice/receipt file. DO NOT put any thing on this line that should not be stripped out if the item does not apply. @BBSFNAME@ Full Name used on BBS @BOARD@ BBS Name @DATE@ Todays Date @TIME@ Present Time @CARDTYPE@ Card Type (Mastercard, Visa Etc) @CCNAME@ Name entered from User as Purchaser @STREET@ Street Address @CITY@ City @STATE@ State @ZIP@ Zipcode @HPHONE@ Home Phone @WPHONE@ Work Phone @PROCESSOR@ Merchant Processor Name @CARDNUMBER@ Credit Card Number (Formatted) @TAXSTATE@ State to charge tax @CCEXPIRE@ Credit Card expire date @TYPEORD@ Type of Purchase (Credit card, CheckMO, COD) TeleShoppe 2.01 APPENDIX D ────────────────────────────────────────────────────────────────────────── @SHIPTYPE@ Shipping vendor name @INVNO@ Invoice Number (Between 1 and 32767) @ITEMS@ Items ordered. These items are formated. create an Invoice or Receipt to see the format. ITEMS MUST BE CALLED BEFORE ANY OF THE FOLLOWING FIELDS. @SUB_TOTAL@ Subtotal of ITEMS (Call after ITEMS ONLY) * @BREAK@ Break Point cost (Call after ITEMS ONLY) @TAX@ Tax amount (Call after ITEMS ONLY) * @VTAX@ Variable Tax (Call after ITEMS ONLY) * @SHIPPING@ Amount of Shipping (Call after ITEMS ONLY) * @HANDLING@ Amount of handling (Call after ITEMS ONLY) @TOTAL@ Final Total (Call only after all above) To accurately calculate the proper values the items that have "CALL after ITEMS ONLY" must be placed on a line lower than @ITEMS@, This allows TeleShoppe to calculate the total cost of items before attempting to calculate those values.